<!--$Id: xa_intro.so,v 10.22 2001/03/30 20:34:54 bostic Exp $-->
<!--Copyright (c) 1997,2008 Oracle.  All rights reserved.-->
<!--See the file LICENSE for redistribution information.-->
<html>
<head>
<title>Berkeley DB Reference Guide: XA Introduction</title>
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++">
</head>
<body bgcolor=white>
<a name="2"><!--meow--></a><a name="3"><!--meow--></a>
<table width="100%"><tr valign=top>
<td><b><dl><dt>Berkeley DB Reference Guide:<dd>Distributed Transactions</dl></b></td>
<td align=right><a href="../xa/build.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../xa/xa_config.html"><img src="../../images/next.gif" alt="Next"></a>
</td></tr></table>
<p align=center><b>XA Introduction</b></p>
<p>Berkeley DB can be used as an XA-compliant resource manager.  The XA
implementation is known to work with the Tuxedo(tm) transaction
manager.</p>
<p>The XA support is encapsulated in the resource manager switch
db_xa_switch, which defines the following functions:</p>
<blockquote><pre>__db_xa_close     Close the resource manager.
__db_xa_commit    Commit the specified transaction.
__db_xa_complete  Wait for asynchronous operations to
                  complete.
__db_xa_end       Disassociate the application from a
                  transaction.
__db_xa_forget    Forget about a transaction that was heuristically
                  completed. (Berkeley DB does not support heuristic
                  completion.)
__db_xa_open      Open the resource manager.
__db_xa_prepare   Prepare the specified transaction.
__db_xa_recover   Return a list of prepared, but not yet
                  committed transactions.
__db_xa_rollback  Abort the specified transaction.
__db_xa_start     Associate the application with a
                  transaction.
</pre></blockquote>
<p>The Berkeley DB resource manager does not support the following optional
XA features:</p>
<p><ul type=disc>
<li>Asynchronous operations
<li>Transaction migration
</ul>
<p>The Tuxedo System is available from <a href="http://www.beasys.com">BEA Systems, Inc.</a></p>
<p>For additional information on Tuxedo, see</p>
<blockquote><i>Building Client/Server Applications Using Tuxedo</i>,
by Hall (John Wiley & Sons, Inc.).</blockquote>
<p>For additional information on XA Resource Managers, see</p>
<blockquote>X/Open CAE Specification
<i>Distributed Transaction Processing: The XA Specification</i>,
X/Open Document Number: XO/CAE/91/300.</blockquote>
<p>For additional information on The Tuxedo System, see</p>
<blockquote><i>The Tuxedo System</i>,
by Andrade, Carges, Dwyer and Felts (Addison Wesley Longman).</blockquote>
<table width="100%"><tr><td><br></td><td align=right><a href="../xa/build.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../xa/xa_config.html"><img src="../../images/next.gif" alt="Next"></a>
</td></tr></table>
<p><font size=1>Copyright (c) 1996,2008 Oracle.  All rights reserved.</font>
</body>
</html>
